<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Homepage for bugzproxy - The Bugzilla C# Proxy</title>
</head>

<IMG src="overview.png" alt="Overview" width="152" height="443" align="right" border="0">

<h1>What is the Bugzilla C# Proxy</h1>

<p>Bugzproxy is a C# based assembly that provides access to a Bugzilla
server, using the WebService interface of Bugzilla 3.0 or newer (at
least 3.0.2 recommended)</p>

<p>The assembly provides an object oriented API for accessing a
Bugzilla server, allowing other tools to be easily built on top of
this assembly. This includes command line tools, SCM integration
tools, and MonoDevelop and Microsoft Visual Studio plugins.</p>

<h1>News</h1>

<p>2008.01.17: A new release: version 0.2.0. Now supports the
AppendComment call in very recent versions of Bugzilla, thanks to
Tsahi Asher. Note, that the API, mostly the namespace, has changed for
this version, and applications build against the earlier release will
probably not compile with this. The API should follow .net conventions
a bit closer now, and most changes are of the "search/replace" kind -
there should be no major changes.</p>

<p>2008.01.03: Updated samples to use a common set of options. All
sample programs now use the Bugzilla landfill server, using a default
account. Changed the Linux compilation to use xbuild on the csproj file.</p>

<p>2007.11.26: Lots of changes are currently going in to the SVN
repos, so the API is in somewhat of a flux.</p>

<p>2007.11.20: Migrated CVS to SVN at sourceforge. You need to use the
new SVN path at
https://bugzproxy.svn.sourceforge.net/svnroot/bugzproxy now.</p>

<p>2007.06.29: Updated CVS. Now with ssl support, provided by JP Rosevear</p>

<p>2007.06.28: Updated CVS. Now has VS 2005 build support, and a new
LoggedIn property. Examples against landfill may be broken. New
"Users" section below.</p>

<p>2007.02.26: Bugzilla 3.0RC1 released. Please use the CVS version of bugzproxy to access an installation of 3.0RC1.</p>

<p>2006.11.28: CVS updated with support for landfill.bugzilla.org/bugzilla-tip</p>

<p>2006.11.28: First release</p>

<h1>Requirements</h1>

<p>The WebService support in Bugzilla is still under development. To
actually use this assembly, you need an installation of Bugzilla
  3.0.2 or newer.</p>

<p>You also need the xml-rpc.net assembly from <a
href="http://www.xml-rpc.net/">http://www.xml-rpc.net/</a>. This
assembly was developed with version 2.1.0 of xml-rpc.net.</p>

<p>Additionally, this assembly requires the .NET 2.0 platform (because it
uses nullable types, which are not part of .NET 1.x).</p>

<h1>License</h1>

<p>This code is licensed under the LGPL, v.2. This goes for all code
files, even those with no license included. All files are copyright
<a href="http://www.dbc.dk/">Dansk BiblioteksCenter A/S</a>, 2006 & 2007.</p>

<h1>Downloading</h1>

<p>The project lives, apart from these html pages at <a
href="http://sourceforge.net/projects/bugzproxy">sourceforge</a>. You
can access the SVN repository and file releases from there.</p>

<h1>Building The Assembly</h1>
  
<p>The assembly has been developed under Linux, using Mono (1.2.6) and
is known to work with Windows.</p>

<p>A .csproj file is provided for Windows. For Linux you either use
this directly (with xbuild or MonoDevelop) or use the supplied
Makefile, which calls xbuild.</p>


<h1>Testing/trying It Out</h1>

<p>A number of simple command line programs are included that serves
both as test programs, and as an example on how to use the
assembly. The programs are referenced from the <a
href="html/index.html">documentation</a>.</p>

<p>Note, that the sample programs "ServerInfo", "ListProducts",
"ListBug" and "ListBugs" by default access the <a
href="http://landfill.bugzilla.org/bugzilla-tip">Bugzilla CVS Head
Test Server</a>. This allows you to test Bugzproxy against a live
Bugzilla installation, without having to install one
yourself. However, as the Bugzilla CVS Head Test Server is, by its
very nature, unstable, you may experience some weirdness, when running
these programs. The server is updated on an hourly basis, so if
experience weirdness, please try running the programs again in a few
minutes.</p>

<h1>Status</h1>

<p>As the main purpose of this assembly is to provide an object oriented
API, the most important aspect of the implementation is the design of
the API. This is currently evolving. The code itself is mostly a
rather thin layer, utilizing the xml-rpc.net assembly for all the hard
work.</p>

<h1>Support</h1>

<p>You can find the mailing list via <a
href="http://sourceforge.net/projects/bugzproxy">sourceforge</a>.</p>

<p>The main developer is Mads Bondo Dydensborg (mbd (aaaaa)
dbc.dk). Feel free to mail him for questions (although the mailing
list is the preferred method of contact, I am very happy to hear from
you. It is a lot easier to argue that DBC should sponsor this project
as an open source project, when I get some contribution or feedback
from users).</p>

<h1>Documentation</h1>

<p>The assembly is documented using a Doxygen, and you can find the
documentation <a href="html/index.html">here</a>.</p>

<h1>Users</h1>

<ul>
  <li>Sebastien Santoro has made an <a
  href="http://www.dereckson.be/Blog/index.php/2007/06/28/60-bugzilla-add-bug-wizard">Open Source BugCreate wizard</a>, that utilizes bugzproxy.
  </li>
</ul>

<p>Last updated January 2008.</p>
</html>
